60449800 



CONTRpL DATA 
CORPORATION 



CYBER LOADER 
VERSION 1 
INSTANT 



CDC® 

OPERATING SYSTEMS: 

NOS 2 

NOS/BE 1 



REVISION RECORD 



Revision 



Description 



A Original printing. This manual is a 

successor publication to publication 
number 60372200 for users of the NOS 
1.0, NOS/BE 1.0, and SCOPE 2.1 
operating systems. 

B (05/05/77) This revision documents Version 1.3 of 

the CYBER Loader for the NOS 1 and 
NOS/BE 1 operating systems. (Refer- 
ences to the SCOPE 2 operating system 
have been removed.) This revision is 
effective with release of PSR level 446. 

C (08/01/79) This revision documents Versions 1.4 

and 1.5 of the CYBER Loader. Version 
1.4 introduced the Fast Overlay Loader, 
multiple entry points in the main over- 
lay, a new DEBUG PRESET option and 8 
lines/inch for map output. Version 1.5 
introduced SEGLOAD common blocks and 
PTEXT table. This revision is effec- 
tive with the release of PSR level 498. 

D (04/25/86) CYBER Loader for NOS 2 and NOS/BE 1 

operating systems. (References to the 
NOS 1 operating system have been 
removed.) This revision is effective 
with release of PSR level 647. 



REVISION LETTERS I, 0, Q, AND X ARE NOT USED 



Address comments concerning this manual to: 

CONTROL DATA CORPORATION 
Publications and Graphics Division 
P. 0. BOX 3492 

SUNNYVALE, CALIFORNIA 94088-3492 



®C0PYR1GHT CONTROL DATA CORPORATION 1975, 1977, 1979, 

1986 
All Rights Reserved 
Printed in the United States of America 



60449800 D 



LIST OF EFFECTIVE PAGES 

New features, as well as changes, deletions, and 
additions to information in this manual are indicated 
by bars in the margins or by a dot near the page number 
if the entire page is affected. A bar by the page 
number indicates pagination rather than content has 
changed. 



Front Cover 


_ 


Title Page 


- 


11 


D 


lli/lv 


D 


v/vi 


D 


vli 


D 


vlii 


D 


1 thru "3 


C 


4 


D 


5 


D 


6 thru 8 


C 


9 


D 


10 


C 


10.1 


D 


10.2 


D 


10.3/10.4 


D 


11 thru 15 


C 


16 


D 


17 


D 


18 


C 


19 


D 


20 thru 30 


C 


31 


D 


32 


D 


32.1/32.2 


D 


33 thru 36 


C 


37 


D 


38 


D 


39 thru 50 


C 


51 thru 54 


D 


54.1/54.2 


D 


55 thru 60 


C 


Back Cover 


- 



60449800 D lii/iv 



PREFACE 

This manual summarizes features of the CONTROL DATA® 
CYBER Loader, which is included as part of the following 
operating systems: 

NOS/BE 1 for the CDC® CYBER 170 Series, CYBER 70 
Models 71, 72, 73, 74, and 6000 Series Computer Systems 

NOS 2 for the CDC CYBER 180 Series; CYBER 170 Series; 
and CYBER 70 Models 71, 72, 73, and 74 

The user is assumed to be familiar with the operating system 
and computer system in use. 

More detailed information can be found in the CYBER Loader 
Version 1 Reference Manual, publication number 60429800. 

United States sites can order CONTROL DATA publications 
from Control Data Corporation, Literature and Distribution 
Services, 308 North Dale Street, St. Paul, Minnesota 55103. 
Other sites should order CDC manuals through their local 
country sales office. 
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TYPES OF LOADING 

ABSOLUTE LOADING 

Involves no relocation of addresses or linkage symbols. 

Consists of loading one or two blocks. One block resides in 
central memory; one is optional and resides in extended core 
storage (ECS). 

RELOCATABLE LOADING 

Involves the actual connecting of one or more blocks defined 
through programs. 

Relocates addresses and links externals. 

Permits loading of programs produced by independent compila- 
tions and assemblies. 



BASIC LOADING 

Involves cases in which all of the object code is loaded into 
memory concurrently, resulting in a single core image. 



SEGMENTATION 

Permits selected portions of the program to be in core 
concurrently. Different core images reside in the same area of 
memory at different times. 

Loading is dynamic and results from implicit calls. 



OVERLAY GENERATION 

Permits selected portions of the program to be in core 
concurrently. 

Provides an overlay structure compatible with previous 6000 
series loaders. 

Loading results from explicit loader calls. 
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CAPSULES 

Provides for the dynamic loading and unloading of specially 
processed relocatable code from an executing program. 

The executing program issues an explicit call to the Fast 
Dynamic Loading (FDL) routine, which in turn loads and unloads 
the capsules. 

Capsules must be formed into groups and placed in a library 
before they can be loaded by the FDL routine. 



OVCAPS 

Provides for the dynamic loading and unloading of portions of 
overlayed programs. 

OVCAPs are loaded and unloaded by a call to the FDL routine 
from a currently loaded overlay. 

OVCAPs are generated during an overlay generation load 
sequence and are analogous to primary overlays. 
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CONTROL STATEMENTS 

NAME CALL STATEMENT 



Formats: 



(na 



fname( Pl p n ) 

name A file name or entry point name within a program 
of one to seven characters that identifies a 
program that is to be loaded into central memory. 

p. Parameters to be passed to the loaded program. 

A name call statement is the last or only statement in a load 
sequence. The name type is determined by a search of: 

Local files 

Global library set 

Local library set 

Default system library 

LOADER (VERB) STATEMENTS 

The first field in a verb statement represents an explicitly 
defined loader command. Execution of a verb statement causes 
subsequent statements to be interpreted as loader control 
statements until either an EXECUTE, NOGO, or name call is 
encountered. 

Once in the loader control sequence, operating system control 
statements are interpreted as name call statements. Excep- 
tions are MAP and REDUCE, which the system recognizes 
within the loader control sequence for compatibility with 
previous systems; DMP is recognized but ignored. 

An EXIT statement must not appear inside a load sequence. 

Loader statements are listed below in alphabetical order. 

CAPSULE(pname,, . . . ,pname n ) 

Specifies the components of capsules to be generated. The 
program names (pname.) list in order the programs that 
signal the start of a new capsule. 
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EXECUTE. 
EXECUTE(eptname) 

EXECUTE(eptname,p 1 p ) 

EXECUTEt.Pj p n ) 

Causes completion of the load followed immediately by 
execution of the loaded program at an entry point 
(eptname) optionally specified. Unsatisfied externals are 
satisfied from the library set. p. are optional execution 
time parameters. ' 



GROUP(groupname) 

Specifies the name of a capsule group. It applies to the 
capsules specified by the CAPSULE statements following 
the GROUP statement. 



LDSET(option, option.) 

Provides user control of a variety of load operations. 

Options are described in table 1 and are specified in one of 
the following forms: 

key 

key=param 

key=paranij/ . . . /param 

LDSET options apply for the current load sequence only. 

LIBLOAD(libname,eptname 1 eptname ) 

Requests a physical load of one or more programs from a 
library (libname) according to entry point names 
(eptname.). 



LOADUfn, , . . . ,lfn ) 
1 n 

Requests physical load of either object programs from each 
of the files (lfn,) specified in the sequence or a single 
absolute overlay from a single file. A file name can be 
optionally accompanied by a rewind indicator (/R or /NR). 
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NOGO. 

NOGO(lfn) 

NOGO(lfn,eptname, eptname ) 

Specifies no execution and optionally saves the core image 
on the named file (lfn). One or more entry point names 
(eptnamej) can be specified for inclusion in the overlay 
as program entry points of the absolute program. 



SATISFY. 

SATISFY(libname 1( . . . AibnameJ 

Provides for the satisfaction of unsatisfied externals prior 
to normal satisfaction at load completion, and optionally 
names user-specified libraries (libname.) from which the 
externals are to be satisfied. 



SEGLOAD(p 1 ,p 2 ,p 3 ) 

Specifies that the load is to be a segmented load. 



SLOADUfninamep . . . .name ) 

Requests physical load of selected programs (hamej) 
from a local file (lfn). The file name is optionally 
accompanied by a rewind indicator (/B or /NR). 
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TABLE 1. LDSET OPTIONS 



Key 



Parameters 



COMMON lebname,/ 

. . . /lebname 



COMMON 



EPT 
and 
NOEPT 



. /eptname 



ERR 



Description 



Assigns named labeled common blocks to segments such that the blocks will be available to 
all segments that reference them. Applies to SEGLOAD only. 



Causes all labeled common blocks to be available. 



Provides control over the entry points of capsules, overlays, and OVCAPs. 



Selects one of three methods of handling errors. If no ERR option is specified, the installa- 
tion default is used. Catastrophic errors always result in job abortion. Also, there are 
informative errors that never result in job abortions. 

E Significance 

ALL The program is aborted for errors that are: Fatal 

Nonfatal 

Catastrophic 
FATAL The program is aborted for errors that are: Fatal 

Catastrophic 

NONE Only catastrophic errors cause job abortion. For any other type of error, processing 
continues if possible. 



FILES 
or 

STAT 


lfiy . . . /lfn n 


Permits a CYBER Record Manager user to assure that library programs are loaded for the 
processing of specified files. The FILES or STAT option is treated as a no-op in segment 
generation; its application is the same as in USE for overlay generation. 


LIB 


libnamej/ 
. . . /libname 


Specifies one or more libraries comprising the local library set. 


LIB 




Causes the local library set to be cleared. 

NOTE 

The global library set is altered by use 
of the LIBRARY control statement. 


MAP 


p/lfn 

/lfn 

P 


Controls the generation of the load map. 

lfn Specifies file to receive the map. Default is OUTPUT, lfn is not rewound. 

p Specifies map contents: 

omitted Current job default, as set by the last MAP or installation default 

N No map 

S Statistics 

B Block map 

E Entry point map 

X Entry point cross-references 

Map options S, B, E, and X can be concatenated (for example, LDSET,MAP=BX). 



TABLE 1. LDSET OPTIONS (Contd) 



Key 


Parameters 


Description 


OMIT 


eptname../ 
. . . /eptname 


Specifies that named entry paints are to remain unsatisfied. 

An OMIT request is in effect from the time it is encountered until the end of the load or 
until superseded by a USE request; for example, OMIT(XYZ) later followed by USE(XYZ). 


PD 


P 


Provides control over print density of load map. Must be set to 6 or 8 before printing 
starts. 


PRESET 

and 

PRESETA 


P 


Specifies the values to which unused memory is set prior to execution of the loaded program. 
The loader also presets memory at various times during loading, always using the most 
recent preset selection. 

For PRESETA, the lower 17 bits (central memory) or lower 24 bits (ECS) of each word 
contain its address. For example, if PRESET A=ONES were specified with locations 
RA+1000. and RA+1001„ unused, they would be set to: 

7777 7777 7777 7740 1000 

and 

7777 7777 7777 7740 1001 



PS 



REWIND 

and 

NOREWIN 



Under NOS/BE 1, p can be an octal number of 1 to 20 digits, optionally prefixed by + or - and 
optionally suffixed by the letter B. Under all operating systems, p can be one of the follow- 
ing keywords: 

p_ Octal Preset Value 

NONE No presetting for ECS; same as ZERO for CM 

ZERO 0000 0000 0000 0000 0000 

ONES 7777 7777 7777 7777 7777 

INDEF 1777 0000 0000 0000 0000 

INF 3777 0000 0000 0000 0000 

NGINDEF 6000 0000 0000 0000 0000 

NGINF 4000 0000 0000 0000 0000 

ALTZERO 2525 2525 2525 2525 2525 

ALTONES 5252 5252 5252 5252 5252 

DEBUG 6000 0000 0004 0040 0000 



Provides control over page size of load map. Map is printed at p lines per page. 
lOspsl 000 000. 



Alters the default option for rewinding of files before loading. The selection of /R and 
/NR on the LOAD and SLOAD statements takes precedence over this option. 



TABLE 1. LDSET OPTIONS (Contd) 



Key 



SUBST 



USE 



USEP 



Parameters 



• • • /pair n 



eptnamej/ 
. . . /eptname 



pnamej/ . 
pname 



Description 



paiTj Pair of entry point names in the form: 
eptname.-eptname. 

Changes the external references to entry point names to other entry point names. For 
example, a reference to external eptnamej becomes a reference to external eptname„. 



Forces the loading of object programs to ensure that specified entry points are included in 
the load. The loader loads the programs the next time the loader satisfies externals, either 
as a result of a SATISFY statement or load completion. If the loader is unable to find an 
entry point name in the libraries searched, it flags a nonfatal error. 

During overlay generation, a USE applies only to the overlay begun by the last OVERLAY 
directive read from the last or only file named in the most recent LOAD directive. If the 
USE occurs prior to the first LOAD directive, it applies to the first overlay. 



Causes the indicated programs to be loaded whether or not they are needed to satisfy 
external references. The loader loads the programs the next time the loader satisfies 
externals, either as a result of a SATISFY statement or load completion. 



LOADER-RELATED CONTROL STATEMENTS 

MAP STATEMENT 

Specifies the default option for load maps for load sequences 
requested by the job. 

Formats: 



('MAP. 



fMAP(p) 



p specifies type of map: 

omitted Resets load map option to installation 
default. 

OFF No map. 

PART Statistics and block map. 

ON Statistics, block map, and entry point 

cross-reference. 

FULL Statistics, block map, entry point map, 

and entry point cross-reference. 

LIBRARY STATEMENT 

Specifies a set of global libraries that are searched to satisfy 
externals and name call statements. Also specifies the order in 
which the libraries are to be considered. 

Formats: 

[LIBRARY. 



(LlBRARYflibnamel, . . . , libnamen) 
(LERARYClibnamel, . . . ,libnamen/p) 
p Specifies one of the following options: 
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A Add libraries to global library set. 

D Delete libraries from global library set. 

R Replace global library set with specified 

library set. 



REDUCE STATEMENT 

Specifies whether or not the loader is to determine field length 
assignment. 



Formats: 
^REDUCE. 
NOS/BE batch and NOS only. 



(ilEDUCE(ON) 
NOS/BE Intercom only. 
/REDUCE(-) 



NOS only. 



|ilEDUCE(OFF) 
NOS/BE Intercom only. 



('REDUCE. or (llEDUCE(ON) 

Specifies that the loader assigns field length. 



(ilEDUCE(-) or fllEDUCE(OFF) 

Inhibits reduction of the field length by the loader. 
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RFL STATEMENT 

Controls the amount of field length that is used to execute 
program. 

Formats: 



| / RFL(n) 



(^lFL(n,m) 

(RFL(CM=n,EC=m) 

n Central memory field length in octal, 

m ECS field length in octal. 
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USER REQUESTS 
CALLING THE LOADER 



Formats: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LOADER 
LOADER 


paddr 
paddr, CMM 



paddr The address of LDREQ BEGIN. 

CMM Indicates that the Common Memory Manager 
(CMM) is to be used during loading. It must be 
specified if CMM is active at the time of the call. 



The expanded form of the first format of the LOADER macro 
call is: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




RJ 
CON 


=XLOADER= 
paddr 



The expanded form of the second format of the LOADER macro 
call is: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


+ 


RJ 
VFD 


=XLOADER. 
30/paddr 



FORMATTING THE REQUEST TABLE 

Rules: 

A request table must accompany each loader call (LOADER 
macro). 

The table must consist of a header followed by one or more 
loader requests in internal form. 

The table is either generated by the programmer directly 
or generated through LDREQ macro calls. 

The first word of the table is the paddr specified in the 
loader call. 
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The required sequence of LDREQ macro calls is: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


paddr 


LDREQ 


BEGIN, fwasc, . . . 
Generates header 




LDREQ 
LDREQ 


option, ... 

1 Generates 
\ requests in 
J internal format 

option, ..." 




LDREQ 


END Terminates table 



paddr Table first word address. 
LDREQ options are listed below in alphabetical order. 
BEGIN,fwasc,lwasc,fwalc,lwalc 

Generates the table header. 

fwasc Loadable area in central memory. Default is the 
value in RA+65. (bits 17 through 00). 

lwasc Last word address+1 in central memory. Default 
is RA+FL. 

fwalc Loadable area in ECS. Default is RA+65„ (bits 58 
through 36). Bit 59 of paddr+1 is set irfwalc is 
not blank. 

lwalc Last word address+1 of ECS. Default is 
ECSRA+ECSFL. Bit 29 of paddr+1 is set if lwalc 
is not blank. 

CMLOAD,fwa,end 

Specifies load input in central memory, beginning at fwa 
and ending at end. 

DMP.pl ,p2 

Requests a dump within a loader sequence. This option is 
intended for use by a system analyst. See the operating 
system reference manual for parameters. 



12 
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ECLOAD.fwa.end 

Specifies load input in ECS beginning at fwa and ending at 
end. 



END 

Terminates the loader request table. 

ENTRY.teptnamej, . . . ,eptname n ) 

Allows the executing program to obtain addresses of entry 
points that are currently being loaded and/or have pre- 
viously been loaded. 

NOTE 

A user call that includes an ENTRY request 
must not specify limits of the loadable area 
such that the user call request area is 
overwritten. The updated request table must 
be available to the program after the user call 
is completed. 

EXECUTE 
EXECUTE.eptname 
EXECUTE.eptname.faj p n ) 

Provides similar capability and has the same parameters as 
the EXECUTE statement. The EXECUTE option differs 
from the EXECUTE statement, as follows: 

Libraries are not searched automatically 

Blank common is established only if it is declared in 
the load for the first time 

Field length is not altered 

The SATISFY request is required before an EXECUTE 
request if libraries are to be searched to satisfy external 
references. 

FILES,(lfn 1 lfn n ) 

Provides the same capability and has the same subparam- 
eters as the FILES option of the LDSET statement 
(table 1). 
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LIB 

LIB.Qibnamej libname ) 

Provides the same capability and has the same subparam- 
eters as the LIB option of the LDSET statement (table 1). 

LIBLOAD.libname/eptname, eptname ) 

Provides the same capability and has the same parameters 
as the LIBLOAD statement. 



LOAD.dfcij lfn 



n 



Provides the same capability and has the same parameters 
as the LOAD statement. 



MAP.p.lfn 



Provides the same capability and has the same parameters 
as the MAP option of the LDSET statement (table 1). 



NOGO 



Requests load completion. Control is returned to the 
calling program, not the newly loaded program. Externals 
are not satisfied unless satisfied through a SATISFY 
request. 



OMIT.feptnamej eptname ) 

Provides the same capability and has the same subparam- 
eters as the OMIT option of the LDSET statement (table 1). 

PASSLOC.Widj.tj.bj.aj) < ld tl ,t n' b n' a n )) 

Allows an executing program to supply addresses to the 
loader. PASSLOC is an LDREQ option only. 



PRESET.p 
PRESETA.p 

Provides the same capability and has the same subparam- 
eters as the PRESET and PRESETA options of the LDSET 
statement (table 1). 
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SATISFY 

SATISFY.flibnamej^ libname n ) 

Must be used to satisfy externals at load completion. In 
all other respects, this option is the same as the SATISFY 
statement. 



SLOAD,lfn,(name, name n ) 

Provides the same capability and has the same parameters 
as the SLOAD statement. 



SUBST.tpafrj pair n ) 

Provides the same capability and has the same subparam- 
eters as the SUBST option on the LDSET statement 
(table 1). 



USE.feptnamej^ eptname ) 

Provides the same capability and has the same subparam- 
eters as the USE option of the LDSET statement (table 1). 



USEP.fenamej, . . . ,pname n ) 

Provides the same capability and has the same subparam- 
eters as the USEP option of the LDSET statement (table 1). 
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OVERLAYS 

FEATURES 

The overlay structure is compatible with that of previous 
loaders. 

Only main overlays can contain multiple entry points. 

Loading of an overlay results from an explicit user call. 

Organization of object modules into overlays depends on the 
sequential grouping of programs on the load file. 

Three levels of overlays are possible. One main overlay is at 
the lowest level, up to 63 overlays are allowed at the primary 
level, and up to 63 overlays are allowed at the secondary level 
for each overlay at the primary level. 

The main overlay can be loaded in various ways. Other overlays 
must be loaded by explicit calls from a currently loaded 
overlay. 

Memory references between one overlay and another can be 
downward only (except for the initial entry to a just loaded 
overlay). That is, programs in the main overlay cannot 
reference entry points in any other overlay; programs in a 
primary overlay can reference entry points in the main overlay; 
and programs in the secondary overlay can reference entry 
points in either the main overlay or the associated primary 
overlay. 



OVERLAY DIRECTIVE 

Formats: 

|^>VERLAY(lfn,0,0,origin,OV=n) 
| / OVERLAY(f 1 ,{ 2 ,origin) 

lfn Optionally names the file on which the overlay is 

to be written. (A file specified on a NOGO 
statement overrides the file named on the OVER- 
LAY directive.) If lfn is not specified, the overlay 
is written on either the file named on the NOGO 
statement, the file specified on a previous OVER- 
LAY directive, or file ABS. 

ij Primary level number, through 77„. 
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i„ Secondary level number, through 77 g . 

origin Optional parameter specifying the origin of the 
overlay! n ot allowed for the (0,0) overlay. The 
forms of the origin parameter are; 



Cnnnnn 



The overlay is loaded nnnnnng 
words from the start of blank 



Format: 



0=nnnnnn The overlay is loaded at the | 
address specified, nnnnnn must be 
greater than or equal to 110 8 . 

0=eptname The overlay is loaded at the entry | 
point specified. 

0=eptname The overlay is loaded at the entry I 
+ nnnnnn point specified, offset by +nnnnnn. 

OV=n Optional parameter specifying the 

overlay generator is to generate an 
overlay structure suitable for Fast 
Overlay Loader (FOL). n specifies 
decimal number, 0-2000, of higher 
level overlays or OVCAPs in 
overlay structure. OV=n can only 
be specified on the (0,0) overlay. | 



REQUESTING OVERLAY LOADING 
AND EXECUTION 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LOADREQ 


paddr,rel,flag 



paddr An address expression, specifying the first word of 
the parameter area. 

rcl Auto-recall indicator (optional): 

null Control returns immediately. 

not null Control returns after the call is com- 
pleted. 
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flag A keyword indicating special action. Required if 
the Common Memory Manager is active at the 
time of the call. The keywords are: 

null No special action; CMM must not be 
active. 

CMM Indicates an overlay load by a job that 
uses CMM. This call activates CMM if it 
is not already active. 

DATA Indicates that the loaded overlay is to be 
treated as data, such as a system text. 
This call can be made when CMM is 
either active or inactive, and neither 
activates nor deactivates CMM if it is 
present. Both fwa and lwa must be 
supplied in the parameter area, and the 
e bit must not be set. 

Parameter area before the call: 





59 


53 


47 


35 
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paddr 


name 





paddr+1 


h 


h 


see below 
t 


lwa 


fwa 


paddr+2 


ovlname 


res 


paddr+3 


eptname 


res 



1 
h 

tn 

tres 

ts.d 

tn 



A library name, overlay name, or entry point name 
(see below), left-justified with zero fill. 

Primary overlay level. 

Secondary overlay level. 

Number of words-2 in the request (bits 47 and 46). 

Used by CDC (bit 45). 

Used by CMM (bits 43 and 44). 

Load option (bit 42). 



18 
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tv 

tres 

te 

lwa 

fwa 



Overlay load flag (bit 41). 

Used by CDC (bit 37 through 40). 

Automatic execute flag (bit 36). 

The last word address available for load. 

The first word address available for load, 
ovlname The overlay name, left-justified with zero fill, 
eptname The entry point name, left-justified with zero fill. 
Fields specified as res can be used only by CDC. 
Parameter area after an overlay load under NOS 2: 

59 53 47 17 

paddr 

paddr+1 

paddr+2 

paddr+3 

eptaddr Entry point address of the overlay. If n is 2, eptaddr is 
the address of eptname. 

Parameter area after an overlay load under NOS/BE 1: 

59 53 47 35 17 

paddr 

paddr+1 

paddr+2 

paddr+3 



name 





h 


h 





eptaddr 


ovlname 





eptname 






name 


status 


c 


h 


h 


see below 


lwa 


eptaddr 


ovlname 


res 


eptname 


res 



60449800 D 



19 



tn Number of words-2 in the request (bits 47 and 46). 

tres Used by CDC (bit 45). 

t s ,d Used by CMM (bits 43 and 44). 

t u Load option (bit 42). 

t v Overlay load flag (bit 41). 

tres Used by CDC (bit 38 through 40). 

t ne Nonfatal error flag (bit 37). 

t f e Fatal error flag (bit 36). 

status Contents of the field depend on ne and fe, as follows: 

ne fe Contents of Status Field 

Zero 

1 Fatal error code 

1 Error code for first nonfatal error 
1 1 Fatal error code 

c Completion flag: 

1 = Call is completed 

ne Nonfatal error flag: 

= No nonfatal errors occurred 

1 = One or more nonfatal errors occurred 

fe Fatal error flag: 

= No fatal errors occurred 

1 = A fatal error occurred 
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SEGMENTATION 

FEATURES 
A segment can have more than one entry point. 

Segment loads are implicit. Execution of an instruction that 
refers to an entry point in a currently nonloaded segment 
automatically results in calling the SEGLOAD resident program, 
which assumes control of loading segments. 

A segment load can involve more than one level. This feature 
allows gaps in memory between segments that are logically 
connected. 

Object programs can be selected from more than one source 
file. 

Calls for the SEGLOAD loader can be made through the control 
statement only. 

SEQUENCE OF EVENTS 

1. Directive translation 

2. Object program indexing 

3. Object program processing 

4. Execution 

5. Segment loading under control of SEGLOAD resident 

(SEGRES) 

SEGLOAD CONTROL STATEMENT 

Format: 



£ 



EGLOAD( Pl p n ) 

p. Represents the following optional parameters in any 
order: 

I=lfn Identifies the source of directives; 

default is INPUT 

B=lfn Identifies the binary output file; default 

is ABS 

LO=c.c„ Identifies list options for the segment 
loader, depending on the value of c.c„, 
as follows: ' ' 

Neither tree diagram nor directive list 

D Directive list only 

T Tree diagram only 
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DT 
TD 
omitted 



Both directive list and tree diagram 



If the LO parameter is omitted, the list options depend 
on the load map produced. If MAP(OFF) or 
LDSET(MAP=N) is specified, LOO is assumed; other- 
wise, LO=DT is assumed. 

Statements allowed in the same loader sequence as the 
SEGLOAD control statement are: 

namei call 

LOAD 

LIBLOAD 

SLOAD 

EXECUTE 

NOGO 

LDSET 

The rules for programs on files are: 

No program can span record boundaries 

Any embedded directive (for example, OVERLAY, which is 
ignored) must occur in a separate record 



DIRECTIVES 

Syntax: 
General 

Continuation 
Comment 
Page eject 

Label field 

Verb field 



Specification 
field 



Consists of four fields: label, verb, specifi- 
cation, and comment, and uses columns 1 
through 72 of a line. 

Comma in column 1. 

Asterisk in column 1. 

Slash in column 1; remainder of the directive 

is ignored. 

Begins in column 1 or 2 and is terminated by 
a blank. One to seven characters. 

First nonblank character after label; or, if 
columns 1 and 2 are blank, the first nonblank 
character of the line. Terminated by a blank. 

One or more subfields, beginning with the 
first nonblank character after verb. Each 
subfield contains one to seven characters and 
is terminated by , - ( ) or blank. 
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Comment 
field 



Begins after a specification field specia 
character followed by one or more blanks. 



Directives are listed below in alphabetical order: 



Label 



Verb 



bname ; COMMON 



END 



Specification 

bname, , . . . ,bname 
i n 

Renders the labeled common block: 

addressable by all segments. 

eptname. eptname 

Signifies the end of directives and 
optionally, specifies entry points al 
which execution can begin. 



bname EQUAL bname. bname 



g 



segname INCLUDE 



Renders blocks named in the specifica- 
tion field synonymous with the global 
block named in the label field. 



segname GLOBAL bname, 



. ,bname n (-SAVE) 



Renders a labeled common block 
accessible by all segments that do not 
overwrite it, and optionally preserves 
and restores its contents. The named 
blocks are in segname. 

program j program 

Forces inclusion of object programs into 
a specified segment, overriding normal 
assignment. If segname is omitted, 
programs are placed in the root 
segment, segname must be on a TREE 
directive. 



tname 



LEVEL 



TREE 



Divides memory and allows trees to be 
spatially independent. 

expression 

Organizes segments into a tree struc- 
ture, tname is an optional name by 
which the tree can be referenced in 
other TREE directives, expression is a 
string composed of segment names 
and/or tree names linked by - and , and 
grouped by parentheses. 
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)EBUG AIDS 

RAP CONTROL STATEMENT 

ormat: 



[TRAP(p 1 ,p 2 ) 



p. Represents the following optional parameters: 

I=lfn Source of directives; default is INPUT 
L=lfn List output file; default is TRAPS 

'RAP can only be used with basic loads. 



HRECTIVES 

tyntax: 
General 

Continuation 
Comment 
Page eject 

Label field 



Verb field 



Consists of three fields: label, verb, and 
specification, and uses columns 1 through 72 
of a line. 

Comma in column 1. 

Asterisk in column 1. 

Slash in column 1; the remainder of the 
directive is ignored. 

Starts in column 1, contains one to seven 
characters, and is terminated by , - ( ) or 
blank. The field is empty if column 1 is 
blank. 

First nonblank character after label, or first 
character of the line. Terminated by , - ( ) or 
blank. 



Specification First nonblank character after the verb field. 
Specification consists of a list of parameters 
separated by commas or blanks. 

The TRAP directives are listed below; the parameters are 
summarized in tables 2, 3, 4, and 5. 

FRAME 
TRACK 
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TABLE 2. FRAME DIRECTIVE PARAMETERS 



Parameter 


Default 

(No Parameter 

Specified) 


Description 


Keyword 


Phrase 


AT 




BLOCK name 
PROGRAM name 
PROG name 
ABS CM 


octal CM address 
octal CM address 
octal CM address 
octal CM address 


None (parameter is required). 


Specifies the address of the in- 
struction at which the dump is to 
be taken. 


FROM 




BLOCK name 
PROGRAM name 
PROG name 
ABS CM 
ABS EUS 


octal address 
octal address 
octal address 
octal address 
octal address 





First word address for snapshot 
dump. 


FOR 


Decimal number 


fl-fwa (used only if the first 
word address is in central 
memory). No default for 
ECS. 


Specifies the number of words to 
be dumped. 


START 




Decimal number 




1 


Iteration of the AT instruction, at 
which the first dump is to be taken. 



EVERY 


Decimal number 


1 


interval alter wiiiun uie uuuip u» 
to be repeated. 


UNTIL 


Decimal number 


131071 


Last interaction at which the 
dump is to be taken. 


REG 




No register dump. 


Presence of REG specifies that 
the dump is to include the con- 
tents of registers. 



Phrase 



Keyword 



PROGRAM 
or PROG 



BLOCK 



ABS 



Value 



type 



TABLE 3. PHRASES FOR FRAME PARAMETERS 



Value Type 



Alphanumeric program block name, one to seven 
characters. 

Alphanumeric block name, one to seven charac- 
ters. Blank common is indicated as: 

// Central memory (CM) 
//L ECS (FROM only) 



Core memory type: 



CM 
ECS 



Description 



Name of the program block containing the ad- 
dress specified by AT or FROM. 

Name of the block containing the address speci- 
fied by AT or FROM. //L applied to FROM only. 



Type of memory containing the absolute address 
specified by AT or FROM. If type is omitted, 
CM is assumed. 



TABLE 4. TRACK DIRECTIVE PARAMETERS 



Parameter 


Default 

(No Parameter 

Specified) 


Description 


Keyword 


Phrase 


FROM 




PROGRAM name 
PROG name 
BLOCK name 
ABS CM 


octal address 
octal address 
octal address 
octal address 


Entry point (XFER address). 


First instruction in tracing range. 


TO 




PROGRAM name 
PROG name 
BLOCK name 
ABS CM 


octal address 
octal address 
octal address 
octal address 


Last word address of the 
program. 


Last instruction in tracing range. 


WHEN 




PROGRAM pname 
PROG pname 
BLOCK bname 
ABS CM 
ABS EUS 

Ai Registe 
Bi (0 « 1 « 
Xi 
P 


octal address 
octal address 
octal address 
octal address 
octal address 

r 
7) 


A change to any location or 
register causes a dump. 


Dump condition: a dump is taken 
if the contents of the specified 
location or register change value. 
P must change through a jump. 
Normal incrementation of P does 
not cause a dump. 



o i n.ix 1 






range at which to take the first 
dump. 


EVERY 


Decimal number 


1 


Interval after which the dump is 
to be repeated. 


UNTIL 


Decimal number 


131071 


Last iteration at which the dump 
is to be taken. 



TABLE 5. PHRASES FOR TRACK PARAMETERS 



Phrase 



Keyword 



PROGRAM 
or PROG 



BLOCK 



ABS 



type 



Value Type 



Alphanumeric program block name, one to seven 
characters. 

Alphanumeric block name, one to seven charac- 
ters. Blank common is indicated as: 

// CM 

//L ECS 

Core memory type: CM 

ECS 



Description 



Program block referred to by the FROM, TO, or 
WHEN parameter. 

Common block referred to by the FROM, TO, or 
WHEN parameter. 



Type of memory containing the absolute address 
specified by the FROM, TO, or WHEN parameter. 
If type is omitted, CM is assumed. 



CAPSULES 
FEATURES 

Every capsule must be a member of a group. 

Capsules must be placed in libraries before they can be loaded 
by an executing program. 

An executing program must call an FDL subroutine, specifying a 
group name and a capsule name, to load or unload a capsule. 

Entry points and external references of capsules in the same 
group are automatically linked or delinked when the capsule is 
loaded or unloaded by the FDL subroutine. 

Statically loaded code can interface with dynamically loaded 
code through the use of PASSLOC tables. 

A capsule can be loaded statically as input to basic loads, 
overlay generation loads, segment generation loads, and all 
other situations where standard relocatables are allowed. 

GENERATING CAPSULES 

GROUP statement format: 



IGROUP(groupname) 



groupname A name of one to seven characters. Any 
valid program name acceptable to the loader 
can be used. 

CAPSULE statement format: 



(CAPSULEtpnamej, . . . ,pname ) 



pname ; The names of programs from the loadfile, 

listed in order, that signal the start of a new 
capsule. These programs must be loaded by 
either LOAD or SLOAD statements. 
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LOADING AND UNLOADING CAPSULES 

The calling sequence for loading capsules is: 

FDL.LDC - LOAD CAPSULE. 

ENTRY (XI) = 42/GROUP NAME, 18/SIZE ESTIMATE. 
(X2) = CAPSULE NAME. 
(X3) = LIBRARY LIST ADDRESS. 
(X4) = PASSLOC/ENTRY LIST ADDRESS. 

EXIT (Bl) = 1. 

(X6) = ERROR CODE: 

= NO ERROR. 

1 = BAD LIBRARY LIST. 

2 = UNKNOWN GROUP NAME. 

3 = UNKNOWN CAPSULE NAME. 

4 = BAD CAPSULE FORMAT. 

5 = BAD PASSLOC/ENTRY FORMAT. 

6 = CAPSULE ALREADY IN MEMORY. 

7 = CAPSULE / OVCAP CONFUSION. 

SAVES AO, XO, B2, B3, X5. 

CALLS CMM.ALF, CMM.CSF, CMM.FRF, 
CMM.SLF, SYS=. 



GROUP NAME The name of the capsule group, left- 

justified with zero fill. 

SIZE ESTIMATE The number of capsules in the capsule 

group; zero if not known. 

CAPSULE NAME The name of the capsule, left-justified 

with zero fill. 



LIBRARY LIST 

ADDRESS 



The address of a list of libraries. 



PASSLOC/ENTRY 
LIST ADDRESS 



The address of a list of 
PASSLOC/ENTRY table addresses. The 
list must be in ascending display code 
order. 
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The calling sequence for unloading capsules is: 

FDL.ULC - UNLOAD CAPSULE. 

ENTRY (XI) = 42/GROUP NAME, 18/IGNORED. 
(X2) = CAPSULE NAME. 
(X4) = PASSLOC/ENTRY LIST ADDRESS. 

EXIT (Bl) = 1. 

(X6) = ERROR CODE: 
= NO ERROR. 

2 = UNKNOWN GROUP NAME. 

3 = UNKNOWN CAPSULE NAME. 

4 = BAD CAPSULE FORMAT. 

5 = BAD PASSLOC/ENTRY FORMAT. 

SAVES AO, XO, B2, B3, X5. 
CALLS CMM.FRF. 



GROUP NAME The name of the capsule group, left- 

justified with zero fill. 

CAPSULE NAME The name of the capsule, left-justified 

with zero fill. 

PASSLOC/ENTRY The address of a list of 
LIST ADDRESS PASSLOC/ENTRY table addresses. 



FREEING UNUSED MEMORY 

The calling sequence for compacting group directories: 

FDL.CGD - COMPACT GROUP DIRECTORY 

ENTRY NONE. 

EXIT (Bl) = 1. 

SAVES A0,X0, B2, B3,X5. 

CALLS CMM.CSF, CMM.FRF, CMM.SLF, MVE =. 
The calling sequence for unloading group directories: 

FDL.UGD - UNLOAD GROUP DIRECTORY. 

ENTRY (XI) = 42/GROUPNAME.18/IGNORED. 
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exit (bi) = 1. 

(x6) = error code: 

- NO ERROR. 

2 - UNKNOWN GROUP NAME. 

10B - GROUP HAS CAPSULES. 

SAVES AO, XO, B2, B3, X5. 

CALLS CMM.FRF. 

GROUP NAME The name of the capsule group, 
left-justified with zero fill. 



LINKING AND DELINKING CAPSULES 

The calling sequence for linking and relocating capsules is: 

RJ = XFDL.REL 

ENTRY (X2) = 42/0, 18/FWA. 

(X4) = PASSLOC/ENTRY LIST ADDRESS. 

EXIT (Bl) = 1. 

(X6) = ERROR CODE: 
=NO ERROR. 

4 =BAD CAPSULE FORMAT. 

5 =BAD PASSLOC/ENTRY FORMAT. 

SAVES AO, XO, B2, B3, X5. 

FWA The address of the first word of the capsule. 

PASSLOC/ The address of a list of PASSLOC/ENTRY 
ENTRY table addresses. The list contains the address 

LIST of a PASSLOC/ENTRY table in the lower 18 

ADDRESS bits of each word. The list is terminated by a 
zero word. 

The calling sequence for delinking capsules is: 

RJ = XFDL.UNR 

ENTRY (X2) = 42/0, 18/FWA. 

(X4) = PASSLOC/ENTRY LIST ADDRESS. 

EXIT (Bl) = 1. 

(X6) = ERROR CODE: 
=NO ERROR. 

4 =BAD CAPSULE FORMAT. 

5 =BAD PASSLOC/ENTRY FORMAT. 
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SAVES AO, XO, B2, B3, X5. 

FWA The address of the first word of the capsule. 

PASSLOC/ The address of a list of PASSLOC/ENTRY 

ENTRY table addresses. The list contains the address 

LIST of a PASSLOC/ENTRY table in the lower 18 

ADDRESS bits of each word. The list is terminated by a 
zero word. 



OVCAPS 

OVCAPs have the same features as capsules except that they 
cannot be loaded by the basic loader in a relocatable load 
sequence. 

OVCAP directive formats: 



(OVCAP. 
(OVCAP (If n) 



lfn File name on which the OVCAP is to be written; 

must be the same file on which the (0,0) overlay is 
written. 

If no file name is specified on either the NOGO 
statement or the OVCAP directive, the binary is 
written to file ABS. 
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LOADING AND UNLOADING OVCAP! 

The calling sequence for loading OVCAPs is: 

FDL.LOC - LOAD OVERLAY-CAPSULE. 

ENTRY (XI) = 42/GROUP NAME, 18/SIZE ESTIMATE. 
(X2) = OVERLAY-CAPSULE NAME. 
(X3) = LIBRARY LIST ADDRESS. 
(X4) = PASSLOC/ENTRY LIST ADDRESS. 

EXIT (Bl) = 1. 

(X6) = ERROR CODE: 

= NO ERROR. 

1 = BAD LIBRARY LIST. 

2 = UNKNOWN GROUP NAME. 

3 = UNKNOWN OVERLAY-CAPSULE 

NAME. 

4 = BAD OVERLAY-CAPSULE 

FORMAT. 

5 = BAD PASSLOC/ENTRY FORMAT. 

6 = OVERLAY-CAPSULE ALREADY 

IN MEMORY. 

7 = CAPSULE / OVCAP CONFUSION. 

SAVES AO, XO, B2, B3, X5. 

CALLS FDL RESIDENT AND FOL RESIDENT. 

GROUP NAME The name of the OVCAP group, left- 

justified with zero fill. 

SIZE ESTIMATE The number of members in the OVCAP 

group; zero if not known. 

OVERLAY- The name of the OVCAP, left-justified 

CAPSULE NAME with zero fill. 

LIBRARY LIST The address of a list of libraries. 

ADDRESS 

PASSLOC/ENTRY The address of a list of 
LIST ADDRESS PASSLOC/ENTRY table addresses. 

The calling sequence for unloading OVCAPs is: 

FDL.UOC - UNLOAD OVERLAY-CAPSULE. 

ENTRY (X2) = OVERLAY-CAPSULE NAME. 

(X4) = PASSLOC/ENTRY LIST ADDRESS. 
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EXIT (Bl) = 1. 

(X6) = ERROR CODE: 
= NO ERROR. 

3 = UNKNOWN OVERLAY-CAPSULE 

NAME. 

4 = BAD OVERLAY-CAPSULE 

FORMAT. 

5 = BAD PASSLOC/ENTRY FORMAT. 

SAVES AO, XO, B2, X3, X5. 
CALLS FDL RESIDENT. 



)VERLAY- 

:apsule name 



'ASSLOC/ENTRY 
.1ST ADDRESS 



The name of the OVCAP, left-justified 
with zero fill. 

The address of a list of 
PASSLOC/ENTRY table addresses. 



=NTRY TABLE GENERATION 

iNTHDR MACRO 



Location 


Operation 


Variable Subfields 


label 


ENTHDR 





label 



An optional label. 



2NT MACRO 



Location 


Operation 


Variable Subfields 


label 


ENT 


eptname.addr 



label An optional label. 

eptname Entry point name. 

addr Optional; entry point address. If addr is not 

specified, then Yeptname will be used. 
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BINARY TABLE FORMATS 

All fields designated res in this section are reserved for use by 
CDC. 



RELOCATABLE PROGRAM 

PRFX table 

LDSET table (optional) 

PTEXT table 

PIDL table 

ENTR, TEXT, REPL, FILL, LINK, XTEXT, SYMBOL, LINE, 
PTEXT, XREPL, XFILL, and XLINK tables 

XFER table (optional) 

ABSOLUTE CENTRAL 
PROCESSOR PROGRAM 

PRFX table 

ASCM, EASCM, ACPM, or EACPM table 



PERIPHERAL PROCESSOR PROGRAM 

PRFX table 
6PPM table 

SYSTEM TEXT OVERLAY 

PRFX table 

ASCM table with i =il=1 and origin=entry=0 



CAPSULE 



PRFX table 
CAPSULE table 



HEADER WORD 



35 



tn 


we 


(depends on type of table) 
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Binary number designating the type of table: 

Table Type 

6000 PPU program or overlay; bits 
59 through 42 contain three alpha- 
numeric characters in display code 

Program identification and length 

Partial-word relocatable text 

Entry point definitions 

Extended relocatable text 

Relocatable text 

Extended relocation fill 

Relocation fill 

Replication of text 

External reference linkage 

Extended external reference linkage 

Transfer point 

Extended replication of text 

Absolute CPU program or overlay 

Absolute CPU program with multi- 
ple entry points 

Absolute program or overlay with 
ECS data 

Absolute program or overlay with 
ECS data and multiple entry points 

5600 SYMBOL Symbol information 

5700 LINE Line number information and object 

code addresses 

6000 CAPSULE Relocatable capsule or overlay- 
capsule (OVCAP) 

Reserved for installation use 



tn 

(octal) 


Mnemonic 


aabb f 


6PPM 


3400 


PIDL 


3500 


PTEXT 


3600 


ENTR 


3700 


XTEXT 


4000 


TEXT 


4100 


XFILL 


4200 


FILL 


4300 


REPL 


4400 


LINK 


4500 


XLINK 


4600 


XFER 


4700 


XREPL 


5000 + 


ASCM 


5100 t 


EASCM 



5300' ACPM 



5400 ' EACPM 



6600 & 
7000 

7700 



6700 
LDSET 
PRFX 



Object directive 
Prefix 



'he header word varies from the general format by not 
mntaining a word count. This table must be the last or only 
able of its program or overlay and is terminated by an end-of- 
ecord. 
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All other tn values 3300 through 7777 are reserved U 
CDC. 

Number of 60-bit words in the table, not counting th 
header word. 





59 


41 


35 


6PPM TABL 

23 11 1 





program name 


res 


fwa 


res 


wc 


1 

wc 


y text words •* 


progranr 
name 


Three let 


ters an 


d/or digits in display code. 



fwa Address of the byte in PPU memory into whicl 

the first byte of the table header word is to b< 
loaded; the first text byte is loaded at PPl 
memory address fwa+5. 

wc Number of 60-bit text words; the number ol 

12-bit bytes is five times wc. 

PIDL TABLE (3400 





59 




47 


35 


17 










3400 


wc 


res 


1 


subprogram name 


length 


2 
wc 


r 




common block descriptors 




/. 



subprogram Same as in the PRFX table. A subprogram name 
name can be the same as a common block name and/oi 

an entry point name without confusion. 

length Number of 60-bit words in the subprogram's local 

central memory block; if this is zero, the block 
length is determined by the largest address intc 
which subsequent tables load text. 
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)escriptor: 
59 



17 



common block name 


t 


length 



ength 



Type of block: 

= central memory 

1 =ECS 

If t is 0, block size is length 60-bit words. If t is 
1, the block size is 8 x length 60-bit words. 



'TEXT TABLE (3500) 

59 47 41 35 32 

I 



23 20 



11 



3500 


wc 


reserved 


er 


reserved 


TLB 


FFB 


f 


res 


r 


s 


reserved 


k 


c 





















V 



TLB 



?c 



FFB f res 



4- 



i 



Conditional relocation base designator. The 
PTEXT table is ignored if cr refers to a common 
block that was first declared by an earlier 
subprogram. 



TLB Text length in bits. 
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FFB First bit in first word to receive first bit of text 
words. 

f =0 text words follow immediately 

=1 next word is replication indicator, followed 
immediately by text words 

r Relocation base designator. 

s Relative first word address; cannot exceed 377777 

octal. 

k Increment in bits between replicated copies of text 

words. If k=0, loader assumes TLB. 

c Replication count. If e=0, loader assumes 1. 



ENTR TABLE (3600) 

5? _ 47 35 



3600 wc 



X 



entry point descriptors 



i 



Descriptor: 



59 




35 


26 


17 


8 





entry point name 


res 


cr 


res 


al 


res 


r 


as 



al 



Relocation base indicator, in the same format as r. The 
descriptor is ignored if cr refers to a common block 
that was first declared by an earlier subprogram. 

Relative value of the entry point if r refers to an ECS 
block. 

Relocation base designator. 

Relative value of the entry point if r does not refer to 
an ECS block. 
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XTEXT TABLE (3700) 



1 



59 


47 


35 


33 




23 







3700 


wc 


res 


e 


r 


s 






text 


groups 









Conditional Flag: 

= Load text unconditionally 

1 = Ignore this XTEXT table if r refers to a common 

block that was first declared by an earlier subpro- 
gram 

Relocation base designator. 

Relative first word address; cannot exceed 7777777„. 



TEXT TABLE (4000) 

59 47 35 33 26 17 



4000 wc res c res r 



wc ] 



text groups 



i 



Conditional flag: 

= Load text unconditionally 

1 = Ignore this TEXT table if r refers to a common block 

that was first declared by an earlier subprogram 

Relocation base designator. 

Relative first word address; cannot exceed 377777„. 
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Text group: 

59 55 51 47 43 39 35 31 27 23 19 15 11 7 3 
1 
2 



16 



t 



1 

2 3 
1 


4 


1 
5 
1 


1 1 1 1 1 1 

relocation indicators 

1 1 1 1 1 1 


1 1 1 1 

13 14 15 16 
1 1 1 1 








text words 





7 



Relocation bytes: 

OOOx No relocation 

lOxx Upper address, positive relocation 

llxx Upper address, negative relocation 

01 Ox Middle address, positive relocation 

Ollx Middle address, negative relocation 

1x10 Lower address, positive relocation 

lxll Lower address, negative relocation 

0010 Lower address, positive relocation 

0011 Lower address, negative relocation 



59 



4100 



wc 



47 



35 



XFILL TABLE (4100) 

20 11 



cr res 



relocation descriptors 



i 



The conditional relocation base designator. The XFILL 
table is ignored if cr refers to a common block that was 
first declared by an earlier subprogram. 
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Descriptor: 

59 53 



29 23 17 



res 


a 


pos 


size 


br 


r 



a Relative address of the text word; can be as large as 

7777777 g . 

pos Bit position of the low-order bit of the address field in 
the text word. 

size Address field length in bits. 

br Base address designator for the relocation quantity. 

r Relocation base designator for the text word address; r 

cannot be 2 (negative program relocation) and cannot 

refer to a blank common block. 



FILL TABLE (4200) 

59 47 



20 



11 



4200 



t 



relocation sequences 



t 



cr Conditional relocation base designator. The FILL table 

is ignored if cr refers to a common block that was first 
declared by an earlier subprogram. 



Header byte: 
29 






res 


br 



Relocation base designator. 



42 
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Trailer byte: 
29 



17 



1 p r 



The address field to be relocated, designated as follows: 

00 = Lower address (bits 17 through 0) 

01 = Middle address (bits 32 through 15) 
10 = Upper address (bits 47 through 30) 

Relocation base designator. 

Relative address; cannot exceed 377777.. 



REPL TABLE (4300) 
20 11 



4300 wc 



t 



replication descriptors 



i 



Conditional relocation base designator. The REPL table 
is ignored if er refers to a common block that was first 
declared by an earlier subprogram. 

Immediate flag: 

= The REPL table is saved when encountered and 

processed when the end of the current load file or 
library is reached 

1 =The REPL table is processed immediately when 

encountered 
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Descriptor: 



59 




44 


41 


26 


17 







res 


k 


rs 


as 


e 


b 


rd 


ad 



Destination address increment: k is added to destination 
address (D) after each copy. If k is 0, the loader uses 
block size (b) for increment size. 

Relocation base designator for the source address (S). 



rd 
ad 



Count; the number of times the block is copied. If c is 
or 1, the loader makes one copy. 

Block size (number of words to be copied) in 60-bit 
words. If b is or 1, the loader copies one word. 

Relocation base designator for destination address D. 

Relative destination address; cannot exceed 377777„. 



LINK TABLE (4400) 

59 47 



4400 



20 



wc |_ 



linkage sequences 



? 



Conditional relocation base designator. The LINK table 
is ignored if cr refers to a common block that was first 
declared by an earlier subprogram. 



44 
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Header byte: 



59 



17 



external name 


res 


w 



Weak external flag: 

= strong 

1 = weak 



59 



47 



4500 



XLINK TABLE (4500) 

35 20 11 



t 



linkage sequences 



or Conditional relocation base designator. The XLINK 

table is ignored if cr refers to a common block that was 
first declared by an earlier subprogram. 



Linkage sequence: 

59 17 



external name 



^7 



linkage descriptors 



zero word 



w Weak external flag: 

= strong 

1 = weak 
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Linkage descriptor: 
59 53 



pos 

size 
r 



23 17 



res 


a 


pos 


size 


res 


r 



Relative address of the text word; can be as large as 

7777777 g . 

Bit position of the low-order bit of the address field in 
the text word. 

Address field length in bits. 

Relocation base designator for the text word address; r 
cannot be 2 (negative program relocation) and cannot 
refer to a blank common block. 



XFER TABLE (4600) 



59 


47 


35 


17 







4600 


0001 


res 


transfer name 


res 



XREPL TABLE (4700) 

5!) 47 35 







4700 



20 



11 



wc |_ 



replication descriptors 



i 



Conditional relocation base designator. The XREPL 
table is ignored if cr refers to a common block that was 
first declared by an earlier subprogram. 

Immediate flag: 

= The XREPL table is saved when encountered and 

processed when the end of the current load file or 
library is reached 

1 =The XREPL table is processed immediately when 

encountered 
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Replication descriptor: 

59 50 44 



ro- 
ad 



32 23 



res 


k 


rs 


as 


c 


b 


rd 


ad 



Destination address increment: k is added to destination 
address (D) after each copy. If k is 0, the loader uses 
block size (b) for increment size. 

Relocation base designator for the source address (S). 

Relative source address; cannot exceed 7777777„. 

o 

Count; the number of times the block is copied. If c is 
or 1, the loader makes one copy. Cannot exceed 
32767. 

Block size (number of words to be copied) in 60-bit 
words. If b is or 1, the loader copies one word. 
Cannot exceed 4095. 

Relocation base designator for destination address D. 

Relative destination address; cannot exceed 7777777„. 



ASCM TABLE (5000) 

59 47 41 35 17 



wc |_ 



fwa 



entry 



text words 



J 
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"1 
h 

fwa 



Primary overlay level number. 

Secondary overlay level number. 

Address of the word in central memory into which the 
table header word is to be loaded; the first text word is 
loaded at central memory address fwa+1. 

entry The address at which execution of the program or 
overlay is to begin. 



EASCAA TABLE (5100) 



k 



k+1 



59 47 


41 


35 




17 







5100 


h 


h 


fwa 


k 
















/ 



i I 



entry point definitions 



*7 



text words 



i 



.,,.,,„ Same as in the ASCM table. If L^U' ' tne s&me 
restrictions on fwa apply. 



I,, I. 



fwa Address of the word in central memory into which the 
table header word is to be loaded. The first entry point 
definition is loaded at central memory address fwa+1, 
and the first text word at fwa+k+1. 

k Number of entry point definitions. 



Entry point definition: 



59 


17 


entry point name 


location 
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ACPM TABLE (5300) 

Format 1 (one unnamed entry point): 

59 47 41 35 23 17 



5300 



f, i„ ^ was ° entry 



fwal 



wel 



wcl 
wel+1 



4 



ECS text words 



wcl+2 



endl 



ends 



wel+3 

wel+ | 
wcs+2 I 



central memory text words 



4 



J 



Format 2 (one or more named entry points): 

59 47 41 35 23 17 



fwas 



k 



entry point definitions 



k+ 
wcl+1 

k+ 
wcl+2 

k+ 
wcl+3 



4 



4 



k+wcl+ 
wcs+3 



fwal 



wel 



ECS text words 



4 



endl 



ends 



central memory text words 



J 
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t£. Overlay level number. 

fwas Address of the word in central memory into which 

the table header word is to be loaded. For 
format 1, the first central memory text word is 
loaded at address fwas+1. For format 2, the first 
entry point definition is loaded at address fwas+1, 
and the first central memory text word at 
fwas+k+1. If J,+i,=0, fwas must not be less than 

ioo 8 . 

entry The address at which execution of the program or 

overlay is to begin. 

k Number of entry point definitions. The comple- 

ment of k is stored in the table to distinguish 
format 2 from format 1. 



entry point Same as in the EASCM table, 
definitions 

fwal Address of the word in ECS into which the first 

ECS text word (if any) is to be loaded. 

wcl Number of ECS text words; can be zero. 

endl The greatest address+1 of the fixed ECS area used 

by this program. If endl is 0, endl=fwal+wcl is 
assumed. 

ends The greatest address+1 of the fixed central 

memory area used by this program. If ends is 0, 
ends=fwas+wcs+l is assumed. 

wes Number of central memory text words. If wcs is 

0, the central memory text words comprise all 
that remains of the ACPM table, which is termi- 
nated by an end-of-record. 



50 60449800 C 



59 S3 47 41 35 



EACPM TABLE (5400) 

23 17 



5400 


h 


*2 


fwas 


number of 
entry points 


wcs 


lminfl 


minfl 


reserved 


fwal 


wcl 


reserved 


reserved 


hha ! 


reserved 


lhha | 


fs 


dl 


ra 


reserved 

/ 


y entry point 


address ly 



,(0,0) 
only 



dl 



entry point 



L2 



relative PRU 



address 



addrel 



addre2 



K0.0) 
/only 



wel* 



ECS image (if any) 



central memory image 



60449800 D 



51 



h*2 

fwas 



fwal 



wol 
minfl 



Overlay level. Words 4 through 7 of the table 
header are present only for level (0,9) overlays. 

The address of the word in central memory into 
which word of the table header is to be 
loaded. The entry point list, the FOL directory, 
and then the central memory image are to be 
loaded immediately following the header. If 
ij=<„=0, fwa must be equal to 100. 

The address of the word in ECS, if any, into 
which the first word of the ECS image is to be 
loaded. 

The number of words in the central memory 
image. 

The number of words in the ECS image. 

The minimum central memory field length 
needed to execute the overlay; equivalent to 
the lwa+1 of the overlay. 



lminfl The minimum ECS field length needed to 
execute the overlay. 



hha 



lhha 

entry 
points 



address 

dl 



52 



The highest high address for central memory; 
the minimum field length needed to execute any 
legal combination of overlays generated as part 
of this overlay structure. This number is 
derived from the values of minfl specified for 
each of the overlays. 

The highest high address for ECS. 

If the overlay was generated because of 
OVERLAY directives in the object stream, or 
because of a NOGO control statement speci- 
fying a file name only, the overlay will have a 
single entry point. Its name will be the same as 
that of the overlay and its address will be that 
of the last transfer address encountered. 

If the overlay was generated because of a 
NOGO control statement (and no OVERLAY 
directives) specifying a file name, and one or 
more entry points, the overlay will contain 
those entry points named on the NOGO state- 
ment with their respective addresses. 

The entry point address. 

The fast overlay directory length (FOL). Two 
words are used for each entry. 

60449800 D 



fs The file specification entry set into 5400 table 

when a FOL overlay structure (0,0) overlay is 
loaded. 

ra The random address set in the 5400 table when 

a FOL overlay structure (0,0) overlay is loaded. 

The following fields are repeated for each overlay on the FOL I 
directory: 1 

name The name of the overlay or OVCAP. 

addrel The address of the first word of the 

overlay. Zero if an OVCAP. 

Li \*i Overlay levels of the remaining overlay in 

the FOL directory. 

relative PRU The PRU address relative to the (0,0) 
overlay. 

addre2 The address of the last word of the 

overlay plus 1. Length if an OVCAP. 



SYMBOL TABLE (5600) 

59 47 35 23 



5600 



we |_ 



to 



reserved 



J 



to Language ordinal, for example: 

2=FTN4 
4=FTN5 
8=BASIC 

z Symbol table entry. Each entry is 2 words long. 

The content of this field is irrelevant to the 
loader. 
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LINE NUMBER TABLE (5700) 

59 47 35 



23 



5700 



io 



reserved 



t 



i 



io Language ordinal. 

z Line number table entry. The content of this 

field is irrelevant to the loader. 



CAPSULE TABLE (6000) 



6000 Header 



Code Image 



Entry Point List 



External Reference List 



Reference Chains 



Relocation Table 



Header: 



59 



47 



35 



23 1817 



6000 


no of 
entry 
points 


no of 
different 
externals 


r 
e 

s 


f 


total length 
of capsule 


group name 


pointer to 
entry point list 


capsule name 


pointer to 
relocation table 



f = 



- Capsule 

1 - OVCAP 
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Entry point list: 
59 



17 



entry point name 


relative 
address 



External reference list: 
59 



external name 



17 



relative 

address 

of ref chain 



L l If originally a 
weak external 
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54.1/54.2 | 



Reference chain: 
19 17 



relative address 
of reference 



•Parcel containing reference 
(1, 2, or 3): 

1 = Upper parcel 

2 = Middle parcel 

3 = Lower parcel 



Relocation table: 

59 



1 1 1 1 1 1 1 1 1 1 1 1 1 1 

* r 3 r 4 r 5 r 6 r 7 r 10 r ll r 12 r 13 r 14 r 15 r 16 
I I I I 1 I I I I I I I I I 
r 17 r 20 r 21 r 22 r 23 r 24 r 25 r 26 r 27 r 30 r 31 r 32 r 33 r 34 r 35 
I I I I I I I I I I I I I L 



Zero, indicating that the three header words are not 
to be relocated. 



LDSET TABLE (7000) 



59 



47 35 



7000 wc 



t 



object directives in internal format 



i 



The LDSET table options are listed below. 
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LIB (0010) 



59 


47 




35 




17 







code 


wc 


res 


name 


res 


name 


res 



















*7 



4 



code Identifies the table type. 

name The name passed by the LDSET option. 

wc Number of names in the table. 

MAP (0011) 
Format 1: 

59 47 35 18 



0011 


0000 


res 


t 


s 



Significance of the t flag: 

= Ignore t and write the default map type 

1 = Write the map type specified by t 

Map type octal code. These options are equivalent to 
LDSET(MAP=) options. Any combination of the follow- 
ing can be specified: 

1 (bit 1) = Statistics (S) 

2 (bit 2) = Blocks (B) 

4 (bit 3) = Entry points (E) 
10 (bit 4) = Entry point cross-references (X) 
The map is written on file OUTPUT. 
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Format 2: 



59 


47 


35 




18 







0011 


0001 


res 


t 


s 


file name 


res 



Format 2 has the same interpretation of s and t as format 1. In 
addition', the map is written on the specified file. 



PRESET/PRESETA (0012) 



Format 


1: 
59 


47 


35 


17 










0012 


0001 


res 


P 


1 


value 



Format 2: 

59 47 _JS5_ 



0012 


0000 


res 



59 



35 



Severity 
ALL 
FATAL 
NONE 



ERR (0013) 
17 



0013 


0000 


res 


P 
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REWIND/NOREWIN (0014) 
59 47 35 



17 



0014 


0000 


res 


P 



£ Position 

Rewind 

1 No rewind 

USER (0015) 

Same format as the LIB (0010) option. 

USE (0016) 

Same format as the LIB (0010) option. 

SUBST (0017) 

59 47 35 







0017 



t 



substitution descriptors 



Substitution descriptor: 
59 



17 



OMIT (0020) 

Same format as the LIB (0010) option. 



J 



external name referenced 


res 


entry point name to be used instead 


res 
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Same format as the LIB (0010) option. 



Same format as the LIB (0010) option. 



EPT (0025) 



NOEPT (0026) 



Same format as the LIB (0010) option. 



5!) 47 35 



COMMON (0032) 



PD (0033) 
17 



0033 


0000 


reserved 


P 



p Print density for load map (6 or 8 lines/inch). 



59 47 35 



PS(0034) 

17 



0034 


0000 


reserved 


P 



p Page size for load map (lines/page). Must be at 
least 10. 
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PRFX TABLE (7700) 
59 53 47 



35 29 



17 11 5 



10 
11 
12 
13 
14 
15 
16 



7700 


0016 


res 


name 


res 


date 


blanks 


time 


blanks 


operating system identification 


processor name 


processor 
version 


processor modification level 


target 


valid 


*F 


type 


hardware instruction requirements 




Comments 
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